---
title: Migrando desde Pelican
description: Consejos para migrar un proyecto existente de Pelican a Astro
type: migration
stub: true
framework: Pelican
i18nReady: true
---

import PackageManagerTabs from '~/components/tabs/PackageManagerTabs.astro'

[Pelican](https://getpelican.com) es un generador de sitios estáticos de código abierto construido en Python.

## Principales similitudes entre Pelican y Astro

Pelican y Astro comparten algunas similitudes que te ayudarán a migrar tu proyecto:

- Pelican y Astro son generadores de sitios estáticos, idealmente adecuados para [sitios web orientados al contenido](/es/concepts/why-astro/#orientado-al-contenido) como blogs.

- Pelican y Astro tienen soporte incorporado para [escribir Markdown](/es/guides/content/#autoría-mdx), incluyendo propiedades frontmatter YAML para metadatos de página. Sin embargo, Astro tiene muy pocas propiedades frontmatter reservadas en comparación con Pelican. Aunque muchas de tus propiedades frontmatter existentes en Pelican no serán "especiales" en Astro, puedes continuar usando tus archivos Markdown existentes y valores frontmatter.

## Principales diferencias entre Pelican y Astro

Cuando reconstruyas tu sitio Pelican a Astro, notarás algunas diferencias importantes:

- Pelican admite escribir contenido en Markdown y reStructured Text (`.rst`). Astro admite [crear páginas a partir de archivos Markdown y MDX](/es/guides/content/), pero no admite reStructured Text.

- Pelican usa archivos HTML y sintaxis Jinja para la plantilla. [La sintaxis de Astro](/es/basics/astro-components/) es un subconjunto de HTML similar a JSX. Todo el HTML válido es una sintaxis válida para `.astro`.

- Pelican fue diseñado para construir sitios web ricos en contenido como blogs y tiene algunas características de blog integradas que tendrías que construir tú mismo en Astro. En su lugar, Astro ofrece algunas de estas características incluidas en un [tema de blog oficial](https://github.com/withastro/astro/tree/latest/examples/blog).

## Migrar de Pelican a Astro

Para convertir un sitio de documentación de Pelican a Astro, comienza con nuestra [plantilla oficial de inicio para documentación Starlight](https://starlight.astro.build) o explora más temas de blog de la comunidad en nuestro [catálogo de temas](https://astro.build/themes/).

Puedes pasar el argumento `--template` al comando `create astro` para iniciar un nuevo proyecto Astro con uno de nuestros inicios oficiales. O, puedes [iniciar un nuevo proyecto desde cualquier repositorio Astro existente en GitHub](/es/install/auto/#plantillas-de-inicio).

  <PackageManagerTabs>
    <Fragment slot="npm">
    ```shell
    npm create astro@latest -- --template starlight
    ```
    </Fragment>
    <Fragment slot="pnpm">
    ```shell
    pnpm create astro@latest --template starlight
    ```
    </Fragment>
    <Fragment slot="yarn">
    ```shell
    yarn create astro --template starlight
    ```
    </Fragment>
  </PackageManagerTabs>

Lleva tus archivos existentes de contenido Markdown para [crear páginas Markdown](/es/guides/markdown-content/). Aún puedes tomar ventaja del [enrutamiento basado en archivos](/es/guides/routing/) copiando estos documentos de la carpeta `content/` de Pelican a `src/pages/` en Astro. Puede que desees leer sobre [la estructura del proyecto de Astro](/es/basics/project-structure/) para aprender dónde deben estar ubicados los archivos.

Pelican puede haber manejado gran parte del diseño y los metadatos de tu sitio por ti. Puede que desees leer sobre [la construcción de diseños de Astro como envoltorios de páginas Markdown](/es/basics/layouts/#plantillas-de-markdownmdx) para ver cómo administrar las plantillas tú mismo en Astro, incluido tu `<head>` de página.

Para convertir otros tipos de sitios, como un portafolio o un blog, consulta más plantillas de inicio oficiales en [astro.new](https://astro.new). Encontrarás un enlace al repositorio de GitHub de cada proyecto, así como enlaces de un solo clic para abrir un proyecto de trabajo en los entornos de desarrollo en línea de StackBlitz, CodeSandbox y Gitpod.

## Recursos de la comunidad

- ¡Añade el tuyo!
